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NOTICE 


The information contained in this manual is believed to be accurate and 
is intended to be used as the Basis for testing the equipments described with 
an Atlantic Research Corporation INTERSHAKE Model DTM-2. 


Due to the nature of software/firmware support and Variations in 
different manufacturers of these equipments, Atlantic Research Corporation 


can assume no responsibility or guarantee that the results achieved will match 
those described herein. 


The user is advised that a revision letter appears after the PROM 
number on the program listing in Appendix A. 


Any written comments for improving the test or this descriptive 
document are welcome. 
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OPERATION 


1.0 GENERAL DESCRIPTION 


This test is applicable to CRT terminals and printers using the protocol of the 3270 series or 
equivalent such as the teletype DATA SPEED 40/4. Provisions are included to test the more recent stand alone 
3275 series which uses a slightly different error recovery algorithm. 


Two major test requirements are: (1) to enable a terminal operator to verify that the terminal is 
Operating properly (with minimal technical support), and (2) to provide in-depth diagnostic capability so the 
INTERSHAKE operator can localize a problem when the terminal is determined to be defective. Additional 
“editing” provisions are included to assist the operators in detail troubleshooting. 


INTERSHAKE (DTM) is used to emulate the CPU or Front End Processor for numerous interactive 
message exchanges with the terminal. INTERVIEW displays selected transmissions for visual analysis of both 
transmit and receive signals. 


Connection of the INTERSHAKE (DTM) into an operating system is accomplished at the RS-232 
interface. Testing may be directed from the CPU location through modems or locally at the terminal without 


modems. 


Point-to-point or multidrop (switched carrier) networks are accommodated to strengthen the 
versatility of the test. 


Network layouts differ (especially for multidrop circuits), and a user should thoroughly understand 
the consequences of taking any part of the system off-line to run this test. 


Unused space ts available in the program to add short test routines that could be useful for special 
applications. The internal capacity of INTERSHAKE can contain seven separate programs of this overall 
sophistication. 

1.1 Features and Capabilities 

The simplicity of permitting the terminal operator to verify correct terminal operation unassisted by 

test personnel is possible because the INTERSHAKE can store selected characters received from the terminal then 


retransmit these characters inserted into an instructional format for display on the terminal. 


This ‘Selective Echo” capability is virtually self-checking, thereby servicing a wider range of operator 
skills. Additional in-depth diagnostics are also included to quickly and accurately define a fault condition. 


TESTS, VERIFICATION, AND ERROR CONDITIONS 
(of 3270 and Data Speed 40/4 Test) 


This test provides a very thorough evaluation of a terminal. Its applications include: 
@ Data communication diagnostics 


e Teaching tool for the BiSync Protocol 


1.1.1 
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Instruction vehicle for terminal operators | 

Front End Processor emulator 

Development aid for terminal application software 
Basis for evaluating terminal vendors 


Printed record of the test completion 


The following paragraphs identify the detailed capabilities provided to the user by this test: 


Keyboard Logic Tests 


All AID keys 

Manual TAB to next non-protected field 

Numeric keys (restricted) 

Upper-lower case 

Buffer address follows cursor (see Paragraph 4.1.3) 


Keyboard lockout by CPU 


Display Logic Tests 


Protected fields 

Protected hidden fields 

Nonprotected hidden fields 

Auto-tab to next nonprotected field 
Cursor addressing (insertion of cursor) 
Attributes 

Erase/write resets cursor home 

Write from last address 

Pincushion of top and bottom lines 
Screen focus and brightness 


Contrast adjustment pattern 
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l. Read the cursor address on the display (to the host CPU) 


me  — 
1.1.3 Terminal Options Displayed 
a. Upper — lower case 
b. Highlight 
C. Blink 


d. Buffer — nonbuffered display 


e. Bell tone 
f. — 
1.1.4 Terminal Communication Tests 
a. Automatic terminal ‘’ENQ” recovery —Should the 3270 _ interactive 


communication not terminate, in an orderly fashion; e.g., with an EOT from the 
DTM, the 3270 will, after 3 seconds, generate an ENO. The ENO will be repeated 
from the terminal approximately every 3 seconds. Upon receiving an ENQ from the 
3270, the DTM will interrupt and issue a RESET and GENERAL POLL. Normally 
an EOT response will be generated by the 3270. The “‘idle’’ condition will be 
RESET and SPECIFIC POLL by DTM with EOT responses from the 3270. | 

b. Automatic text blocking at 256 characters 

c. Number of Sync characters 

d. Operation and timing of RTS, CTS, RLSD, DSR leads 


e. Real time display of turnaround time (for terminal to check BCC and reply) 


f. Terminal detection of BCC error. The error recovery routine of the terminal is fully 
exercised by forcing a BCC error and verifying that the terminal rejects it. 


g. Modem strapping options. 

h. Modem turnaround time. 
1.1.5 BCC Error 

Each transmission received from the 3270 has the BCC calculated by the DTM and verified. ANY 
BCC ERROR terminates the test to “END’’. When the test ends, the INTERVIEW CRT will freeze the last 
DTM-3270 sequence. The DTM BCC error light will be ON. 
1.1.6 No Terminal Response 

After each DTM transmission, the interrupt timer is activated. If no response is received from the 


terminal in 3 seconds, the program issues a RESET and GENERAL POLL. The system will continue to issue 
Reset and General Polls at 3-second intervals until a response is received. 


1-3 


S1842-2A 


1.1.7 Protocol Faults 
The following faults are checked by the DTM program and terminate the test with END. 
a. Out of sequence ACK 0, ACK 1. Note that an AID message in response to a 
SPECIFIC POLL qualifies as an ACK 0, so the first ACK observed in response to 
AID ECHO is ACK 1. 
b. Receipt of RVI or WACK from the 3270. 


C. Receipt of any character from 3270 (as the first NON SYNC character) other than 
SOH, STX, DLE, NAK, EOT. 


d. Receipt of any character from 3270 after SOH other than %. 
e. Character received following % must be “/" or “R"’. 


The reader should refer to the Receive Program Modules in Section ||, Paragraph 2.0, for a definitive 
view of the program termination criteria. | 


1.2 EBCDIC versus ASCII 
The Protocol is independent of the code used; therefore, there are only two changes required: (1) the 
characters must be changed to the correct code and (2) EBCDIC uses a CRC (2-character polynomial) whereas 


ASCII uses an LRC (1 character). 


This document, as written, applies to both EBCDIC and ASCII. The Symbols and Hex characters are 
given for both situations in the applicable paragraphs. Section I| contains the actual program variations. 


1.3 Ordering Information 
The order should specify: 
File D01 PROM SET (3270/EBCDIC) or File D02 PROM SET (3270/ASCII) 


The test described herein will be contained in cells G/H and the special ‘““Form’’ message will replace 
Functions 66 EBCD and 67 (Baudot). : 


Special requests should be made if the user desires one single Prom set to contain BOTH DO1 and 
DO2. 


Tapes may be available in the future for use with the external receive program features of the 
INTERKEY equipped INTERSHAKE. 


2.0 3270 PROTOCOL 

This protocol is of the general BISYNC format. Communication between INTERSHAKE and the 
terminal forms an interactive exchange of messages that cascades until it is several interchanges deep before 
proceeding to the next class of exchange. 

A brief description and the protocol elements tested are summarized below. The appropriate users 


guide for the specific terminal (and support software) should be consulted for more details. Also, there may be 
slight variations in the way some “look-alikes” actually implement the protocol. | 
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The program exercises six different Categories of terminal operation. — 


1. INTERSHAKE generates a general poll after power up to retrieve status and sense 
(S&S) for each device (on the controller). 


2% INTERSHAKE generates a specific poll to request the AID keys be operated; 
received AID characters are echoed to the 3270 screen. 


3: Operating the 3270 Request Test Key (ROTST) causes the INTERSHAKE to 
generate a test message (form) to the terminal. 


a. The first transmission of the form contains a forced BCC error. 


b. A NAK response by the 3270 causes INTERSHAKE to retransmit the test 
message “‘form’’ with a good BCC. 


4. The 3270 operator fills in applicable portions of the test message ‘form’ on the 
CRT to check attributes. 


5. The 3270 sends the entered data to the INTERSHAKE which ECHOES the data to 
the 3270 CRT to verify other attribute characteristics; e.g., (hidden fields). 


6. Completion of the test writes ‘END OF TEST” on the 3270 screen and returns to a 
general poll. 


Details of the protocol are shown in Paragraph 5.5.2. 
3.0 3275 PROTOCOL 

The 3275 protocol is substantially identical to the 3270 protocol except for the recovery from a BCC 
error received by the terminal. All six Categories of tests described in Paragraph 2.0 apply. Changes are to 


Category 3: 


Operating the 3275 Request Test (ROTST) key generates a test message “form” to the 
terminal. 


a. The first transmission contains a BCC error. 


b. The terminal responds with an EOT. 


Cc. INTERSHAKE replies with reset and specific poll to retrieve the Status and Sense. 
S&S, when pending, takes priority over other possible replies. S&S for a BCC error 
is ““A (SP).” | 


d. An RVI response by DTM clears the S&S and the terminal responds with EOT to 
terminate the interchange. Note: for unbuffered 3275 displays the STATUS (error) 
light will remain ON until RVI is received even though the erroneous message is 
displayed. 


e. The 3275 ROTST key must be operated (the second time) to retrieve the message 
again from the DTM-2..... this time with a good BCC. 


Further details of the protocol are shown in Paragraph 5.5.2. 
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4.0 3270/75 OPERATION 

This paragraph describes the operator interaction at the terminal. Refer to Paragraph 5.0 for DTM 
setup instructions. The operator should recognize that a 200 ms polling delay is used. Refer to Paragraph 5.9 to 
decrease or increase the delay. 


4.1 Operator Sequence 3270 


The following sequence of terminal operator interactions with the terminal is shown in the preferred 
order and is illustrated by Figure 4-1, Variations are possible. 


4.1.1 Power up terminal (and controller) and START the INTERSHAKE 
4.1.2 CLEAR key clears CRT. After a delay, the CRT will display AID _ at the home position. The aid 
SYMBOLS will be highlighted. 
4.1.3 Operate the other AID keys and note the display. 
Key Display 
PF 1 AID 1 . Type Read 
PF 2 AID 2 | 
PF 3 AID 3 
PF 4 AID 4 
PF 5 AID 5 
PF 6 AID 6 
PF 7 AID 7 | 
PF 8 AID 8 ao 
PF 9 AID 9 
PF 10 AID : 
PF 11 AID # 
PF 12 AID @ 
ENTER or S/R | AID’ (apostrophe) 
PA 1 AID % 
PA 2 AID > 
Short 
PA 3. AID, (comma) purus 
Clear AID _ (underline) 
4.1.3.1 There are three major types of variations in the AID display depending upon the terminal 


manufacturer (and model vintage). The observed variations are described below. Other patterns MAY NOT be 
indicative of a faulty terminal; however, they should be called to the attention of the user as the application 
programs may be impacted where the response to an AID key is a WRITE instruction from the computer. 


TYPE 1: IBM 3270 ET AL 


@ All ‘‘Long Read’ keys and CLEAR will display ‘‘AID’’ and symbol at the HOME 
location, 


e All “Short Read’ keys will display “AID” and symbol at the CURSOR location. 
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SEQ. DTM TERMINAL NOTES 
A GEN. POLL 
A S&S DA 1 
F | DA2 
RVI @ 


| 
| 
| REPEATS FOR S&S FOR DA2 


@  EOT RESPONSE TO GEN. 
POLL AFTER LAST DEVICE 
S&S AND AFTER RVI. 


B @ EOT RESPONSE TO 
SPECIFIC POLL FOR NO 
TRAFFIC. 
@ PF, PA, CLEAR, ENTER. 
a 4 SPECIFIC POLL 
[ 7 SHORT READS WILL WRITE 
| / : @ AT CURSOR LOCATION (AID 
\ / AE RETS KEYS). ALL OTHERS WRITE 
\ —— AT HOME. 
ECHO Al 7 
YK A. re ae © ROTST CALLS MSG. ROTST 
XA ALWAYS CALLS BAD BCC 
nN \ ACK 1 AND NAK AUTOMATICALLY 
~& gee WILL SEND GOOD BCC REPEAT. 
D SPECIFIC POLL 
®@ © * OPERATOR ENTRY 
ECHO AID 
ACK 1 


E SELECT 


ACK 0 
1 
BAD BCC MSG 
NAK 
GOOD BCC MSG 
ACK 1 


SPECIFIC POLL 


SEQ H OF 3275 
(FIG. 4-4) 


Figure 4-1. 3270 Flow Sequence (2 Devices). 
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TYPE 2: DATA SPEED 40/4 ET AL 


e All Aid keys except CLEAR will display at the CURSOR location. The maximum 
number of AID(s) to be simultaneously displayed will be 21. 


e CLEAR will display at the home location. 

The recommended operator sequence for the Data Speed 40 is: 
Line 1 CLEAR, PF1 to PF9 Displays: 

AID _ AID 1 AID 2 AID3 AID 4 AID5 #AID6 AID7Z7 AID 8 AID 9 
Line 2. PF10, PF11, PF12, PA1, PA2, ENTER (S/R) Displays: 


AID :; AID # AID @ AID % AID > AID '! AID / 


Note: RQTST will momentarily display AID / before the screen is erased and 
the test Form is displayed. 


TYPE 3: OTHER 


@ All Aid keys will display at the HOME location; therefore, only one AID will be 
displayed at a time. : 


4.1.3.2 After the AID symbol the cursor is left in a protected field and the operator may NOT enter data 


from the keyboard here or in the next position. A nonprotected field begins two positions to the right of the 
cursor following an AID echo. 


4.1.4 Operate the CLEAR Key to clear the 3270 display. 
4.1.5 Operate the Request Test (ROTST) key. Momentarily the screen will show AID 1. 
The test message will display the ROTST “form” shown in Figure 4-2. 
High-light attribute options can be determined as follows from the top line: 
“3270 75” is intensified. 
“TEST” is blinked. 


Some models provide for both options. The specific manufacturer’s manual should be consulted to 
determine whether independent fields will interact. 


Cursor position is placed at the start of the first non-protected field. The entire screen is protected 
except for the three non-protected fields defined by > <. The operator manually fills the three fields. 


4.1.5.1 The ALPHA field is filled with any alpha-numeric characters such as the name of the terminal system. 
When the cursor is on the “ <"" symbol at the end of the alpha field, the screen is protected. Operate the cursor 
tab key to move the cursor to the next field. 3 


4.1.5.2 The NUMERIC field is filled with only numeric digits, minus (- ) and period ( . ) such as the date of 
the test. The last (10th) character in the numeric field will automatically tab the cursor to the 
alpha — non-displayed field. 
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Row 
1 3270 75 TEST 
2 
3 KEREKKKKKKRKE KKK KKK KEREREKRRERKEKK KEKE KKKKKK KK 
Ie pitt he hee tla ede ase tem ie ate qeseranne areata cae PROT E CRE Ueto sia ent ecu cea oeenaaneta ddan eae eae 
5 > DISPLAYED < 
6 > < NON-DISPLAYED 
7 
O Athi osetweangasciew samiaca ones NONSPROTEC CED tes eta ey cantante owae aoe 
9 S. weauhs cess < ALPHA 

10 ee ee ere < NUMERIC 

1] > < ALPHA NON-DISPLAYED 

12 

13 


14 INTERSHAKE Analyzes And Finds Your Data Communications Problems Fast. 1234567899 


NOTES: 
1. 3270 75 is highlight. 
. TEST is Blink. 
Row 14 is highlight. 
. Cursor is at Row 9. 
. Pincushion of top row of ***. 
. Leave cursor at end of field on Row 11. 


Oohwh 


Figure 4-2. ROQTST Display. 
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4.1.5.3 The ALPHA NON-DISPLAYED field is also filled with any alpha-numeric characters such as the 
Operator's name. The cursor should be positioned on the “ <"’ symbol at the end of the field. 


4.1.6 Operation of the ENTER key sends the data entered onto the form (plus selected parts of the form) 
to the DTM which then ECHOES the message to be displayed on the screen as shown in Figure 4-3. 


4.1.6.1 Note that the protected, hidden (or non-displayed) field of the original form is now displayed 
“NON-DIS.” All operator entered data in the three fields will also be displayed for verification. 


4.1.6.2 Should the original form be displayed in a default condition, i.e., the proper ACK was not received 
prior to operating ENTER, the “AID ‘ ” would have appeared at the home cursor position of the form. This is 
most likely to occur in a non-buffered terminal or when the terminal does not detect the erroneous BCC 


properly. 


4.1.6.3 The three characters at the home location of the screen show the echo ‘d ENTER aid character and 
the echo’d cursor address (Row, Column) when the ENTER key was operated. | 


« ( ( is displayed when the form has been completely med in Srid the cursor is positioned 
on the <symbol at the end of the third field. 


‘¢S is displayed when the form has not been filled in and the cursor is unmoved from the 
position directed by the ROTST key (Row 9, Column 45). 


‘) "is displayed for the cursor location at the last character position on the screen (Row 
24, Column 80). 


Consult the terminal manual for verification of any other cursor address on the terminal display. 
Many application programs “‘read’’ the cursor position from the terminal to verify that the operator has followed 


the operating instructions properly. This is an important aspect of the test. 


4.1.6.4 After the Enter form (Figure 4-3) is displayed, the terminal Bell will sound (if so equipped and 
enabled). | 7 


4.1.6.5 A Record of the test (Figure 4-3) will be printed automatically by the printer attached to the 
terminal after the terminal Bell sounds. For terminals that do not contain a printer this operation is ignored. 


4.1.6.6 The printed record may contain additional operator entered data such as Circuit Number, Data Rate, 
etc. 


Although the “form” in Figure 4-2 is protected except for the three indicated fields, an AID echo will 
open up an additional nonprotected field beginning two character positions after the aid symbol. 


a. Operate the ROTST key. 


b. After filling in the three standard fields the Operate should position the cursor to 
1" in the test message. 


C: Move the cursor down nine rows to the bottom row and operate the PA1 or PA2 
key. 


d. Observe the AID symbol is echoed as an addition to the form. 


e. | Move the cursor “right” two strokes and it will be at the Home location. 
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ROW 
1 CH ¢ ¢ 3270 75 TEST 
2 
3 
4 
5 
6 NON-DIS 
7 
Gr, aie eee chee eee os aera Seats NON=PROTEGUED 363) enea-bio rutin ovine ens a eae ew wees 
9 > ATL RES CO < 
10 > 12 17 1977 < 
1] > MS T JONES < 
12 
13 
14 
15 
16 
17 
18  INTERSHAKE and INTERVIEW Join Together To Quickly Simulate and Analyze Your Data 
19 Communications Problems. 123450/690 F6C/ =s.2.0 si bieedcdedcewed cued oid boda eed 
GO| sextri peu eb eke Saeed aa ea aan Sew bina Bee Oe ee ewe eta teense es 
CH pe rar dave Ree ial coc tertercas tsar tata eae see aad te vee eect vedere emma Waa Pee nse ee aes a Le lee ace one 
CO geet ee eee he ee EE a UE SR Ge ee ens wre eae eae ees 
23 se evh ers es Sets lobes @ erage Sie vaca igen Sinaia Sree ave asa ease os wes eee de ee ee eee ae ee See SEES 
ae be eiets vd decsacianiien te naa aiena tena ce ee ea piestis Saad ots Roar eae END OF TEST 
NOTES: 
1. Enter Key Symbol at cursor at Home position. 
2. Cursor address (Row) character at position 1 ‘‘C’’ for Row 11. 
3. Cursor address (column) character at position 2 ‘‘C” for Column 46. 
4. NON-DIS on Row 6 was hidden before. 
5. Fields on Rows 9, 10, 11 appear as entered. 
6. Rows 18, 19 are highlight. 
7. Row 19 Column 1 is a space (quickly identifies 80 character row above). 
8. END OF TEST takes the last character position. 
9, Bell rings. 
10. Printer prints contents of CRT. 
11. Row 24 of Dots checks for Pincushion. 


Figure 4-3. Enter Response Display (after ROTST). 
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f. Up to 32 characters may be operator entered on the form until the protected 
3270" field is encountered. 


g. Operation of ENTER will echo the Form as shown in Figure 4-3 with the additional | 
descriptive operator entered data on the top line as shown in Figure 4-3a. 


NOTES 
1. The ENTER and cursor address characters normally 
displayed at the home position are written over and do not 


appear. 

2. The AID symbol is overwritten by END OF TEST. 

3. Terminals that position all ‘write’ instructions at the home 
locations require entering AID at home and this shortens 


the space available. 


4, Other nonprotected fields can be established with any AID 
Echo'd anywhere on the screen. 


5. Care must be exercised not to enter more than 46 
characters since the block will then exceed 256 total 


characters. See Paragraph 4.5.1. 


4.1.7 The test will continue with a general poll, etc., except the keyboard will be locked out. The operator 
should operate the Reset/Local key to resume the test. 3 | 


Refer to Paragraph 5.0 for various edit options to terminate the test, restart the test, or perform an 
“ENDURANCE” checkout. : 


4.1.8 At the end of the test the operator may select the local print mode of the terminal mM sO equipped) to 
obtain a printed record of the test as shown in Figure 4-3. 


4.2 Operator Sequence 3275 


This paragraph describes the deviation to the 3270 spc gwen in Paragraph 4.1.5 required for 
the 3275. Figure 4-4 shows the flow chart of operation. 


4.2.1 Operate the Request Test (ROTST) key. Momentarily AID 1 will be displayed. 

The test message will begin immediately to be written on an unbuffered CRT, and when complete, 
the STATUS LED will illuminate on the 3275 panel momentarily. On a buttered errant, only the STATUS 
light will blink on. . 


The operator must operate the ROTST key again and observe that the form is displayed and the 
OTATUS light did NOT blink on. 


Each operation of ROTST will alternate a bad message, then a good message, than a bad message, etc. 


17 
18 
19 
20 
2] 


= 


S1 842-2A 


CKT 43K16Y-4 ADRS ABA 4.8KBS 3270 75 TEST 


NON-DIS 


> ATL RES CO < 
> 12 17 1977 « 
> OP T JONES < 


INTERSHAKE and INTERVIEW Join Together. To Quickly Simulate And Analyze Your Data 


Communications Problems! 1234567899 #&@/-...... 0... cw ce ee ee eee 


oop eawp PR @eweeeenegeenreeeaenvrenewvrereeeeeee ee eee wmeweewee ewe ee em heh mhmhlClc HOO hl hl Ohl hl OO HO Ohl OhUc Ohh OhUh OmhUhOhUhOOhUchhUhHhUhHhUhhUhhUhOhUhFhUo 


oeeneeneneeeneeeeneeneeneaeenaneereeeeeerereee ee wm ee wow wee mem em hmhl Ohl OC Om hl Ohl Ohh Ohl OC PT HH Ce ee ew we ew ee he Oe 


CD 


Figure 4.3a. Enter Response Display (after ROTST). 
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SEQ. DTM-2 


TERMINAL 


f 
! / we KEYS? 
x | ECHO ‘ip? : 
7 ee 
. ACK 1 


: 
® © 


*ROTST KEY 
ooo 
ECHO AID 
ACK 1 
D 
| | ACK 0 
BAD BCC MSG 

EOT 


SPECIFIC POLL 


TO “Ee” 


NOTES 


*OPERATOR ENTRY @ TERMINAL 


® 
@ 


EOT AFTER LAST DEVICE 


EOT RESPONSE TO GEN. 
POLL AFTER LAST DEVICE 
S&S AND AFTER LAST RVI. 


EOT RESPONSE TO SPECIFIC 
POLL FOR NO TRAFFIC. 


PF, PA, CLEAR, ENTER. 


SHORT READS WILL WRITE 
AT CURSOR LOCATION (PA) 
ALL OTHERS WRITE AT HOME. 


ROTST KEY CALLS TEST 
MESSAGE. FIRST CALL IS 
BAD BCC AND ALTERNATE 
AFTERWARDS. : 


RESPONSE IS [A SPACE]FOR 
BAD BCC FOR KD. 


Figure 4-4. 3275 Flow Sequence (One Device). 
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SEQUENCE i 


ENTER IS “VALID” ONLY AFTER 
ACK 1 RESPONSE TO A GOOD 
BCC MSG. EOT RESPONSE 
(SEQUENCE E) IS FOLLOWED 
OTHERWISE. 


F SPECIFIC POLL 
© 
*ROTST KEY (2nd REQUEST) 
ECHO AID 
ACK 1 
G SELECT 
ACK 0 
GOOD BCC MSG 
ACK 1 
H SPECIFIC POLL 
@ 
“ENDURANCE TEST” ENTER 
: ECHO ENTER 
| 
| ACK 1 
| 
| DOTS TO “END OF TEST” 
LL _.——0 ACK 0 


GEN POLL 
AS SUPPLIED 


Figure 4-4. 3275 Flow Sequence (Continued). 
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4.3 Indicators: 3275 


The 3275 terminal contains an indicator panel. The major communication-oriented indicators are 
described below for the BISYNC, non-diai models. 


SYSTEM READY, terminal and signal source are connected together. 

SYNC SEARCH, blinks during communication. 

SELECTED is on when the CRT is being addressed by the CPU, e.g., during receive message. 

INPUT INHIBITED is on when ie keyboard is locked out due to CPU direction or operator error, 
such as trying to type characters on a protected part of the display. Operate the RESET key to enable the 


keyboard. In the “Endurance” test, the keyboard is locked out to prevent interruption of the test. 


TRANSMIT is on when the terminal transmits. Observation of transmit should show a wink for each 
poll answered. 


STATUS is on for problem conditions within the terminal, e.g., for a received BCC error. 
4.4 Auto-Interactive Mode 


| Set up of the DTM-2 determines whether communication is required between the 3270 operator and 
the DTM-2 operator. 


4.4.1 In the AUTO mode, the DTM operator only sets up and starts the test for the 3270 operator. The 
poll rate is set to 200 ms. Refer to Paragraph 5.9. 


The 3270 operator can control the tests if all the tests perform properly. Tests may fail in two ways. 


A “soft” failure will be detected by the operator (and perhaps not be detected by the DTM). An 
example of a soft failure would be an echo of the wrong AID key such as the PF 2 key displaying AID 3. 


A “hard” failure is detected by the DTM and terminates the test. The test can only be restarted by 
the DTM operator. A hard failure will automatically freeze the last transmission from the DTM and the response 


from the terminal. 


Specifics of where the test failed (supplied by the 3270 operator to the DTM operator) will permit 
the DTM to be set up in the INTERACTIVE mode for detail diagnostics of the protocol by the DTM operator. 


Response time measurements and other protocol details are displayed to the DTM operator in the 
AUTO mode to verify the test progress. 


4.4.2 In the INTERACTIVE mode, the 3270 operator performs a// of the same actions; however, each 
transmission from the DTM is manually released by the DTM operator. The DTM-2 operator is in control of the 


test and “‘interacts” with the DTM as well as with the terminal operator. 


Verbal communication is normally necessary in this mode, though not essential since the 3270 
responses displayed on the INTERVIEW show: 


a. What key was operated 


b. The contents of the 3270 display. 
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A precaution is necessary when using the interactive mode. If the operator delays in releasing the next 
message to the terminal for greater than 3 seconds, the terminal may time out and respond with ENQ (except 
after an EOT from the DTM). The DTM will interrupt itself when receiving an ENO and reply with RESET & 
GEN POLL. 


4.5 Additional Tests 
4.5.1 256-Character Block 


The terminal will automatically limit transmitted text to a maximum size of 256 characters per block. 
A “full” block of 256 characters will end with ETB instead of ETX. This INTERSHAKE test will withhold its 
response to an ETB from the terminal. After the termina! senses that 3 seconds has elapsed without a response, 
the terminal will send an ENQ. INTERSHAKE will detect the ENO and reply with a “‘reset and general poll’. The 
terminal will then resume normal EOT replys to polls. 


Terminal OPERATION 
a. Operate CLEAR and observe AID __ on the terminal. 


b. Move cursor 2 characters to the right into the start of the NONPROTECTED field 
of the Display. 


aa 
e 


C; Operate the (period) key in the repeat mode to write 4 lines of dots on the 
display. Approximately 320 characters of text are now on the screen. 


d. Operate ENTER (S/R) to send the first 256-character Block. The data paths will 
then become quiet for 3 seconds, then Polling will resume ONLY if the terminal 
times out and generates an ENO. 


e. The DTM operator will observe on the INTERVIEW the 256-character message 
ending with ETB followed by the ENQ which resumes the normal poll response. _ 


f. Operate CLEAR on the terminal and observe the Echo'd AID __ as this test cycle is 
now complete. 


4.5.2 Three-Second Terminal ““ENQ” Recovery 


When the terminal does not receive an anticipated reply within 3 seconds, an ENO will be generated. 
The terminal will repeatedly send ENO at 3-second intervals unless the last transmission received ended with 
EOT. A technique for verifying this ENO recovery is described in Paragraph 4.5.1. 


5.0 DTM-2 OPERATION (AND EDITING) 


This program is a rather inclusive general purpose program. Extensive features are built in that they 
may be enabled or disabled, or parameters may be edited, etc. Table 5-1 liststhe Edit options described in 
Paragraphs 5.2 through 5.11. Edit steps are identified in the program in Appendices A and B. 


EDITING THE PROGRAM. The address of the step to be edited is written as STEP-PAGE and HEX 
(_) to accommodate the widest possible user experience and familiarity with numbering systems. 


ADDRESS EXAMPLE: 63-1 (7F) 


STEP — PAGE — (HEX) 
63 — 1 — (7F) 
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As a further aid to the user the data or function to be edited is enclosed ( ) on the program listings in 
Appendices A and B. 


5.1 Loading the Program 


This program requires that the DTM operate in the 256-step cell mode. Internal switch #5 must be 


ON and the LEFT decimal ON at the PAGE display to indicate the 256-step cell is selected. (The decimal OFF 
indicates the 128-step cell mode.) 


5.1.1 = The program may be manually loaded into cells C/D, E/F, or G/H. The program should not be 
manually loaded into cell A/B under normal situations as cell A/B is reserved as a scratch pad for all stored tests. 


5.1.2 This test is available as special firmware PROMS which can be installed as one of the INTERSHAKE 
STORED TESTS. This test is supplied in cell G/H. Operating the DTM with the LOAD toggle in AUTO will place 
the program into RAM cell A/B where the program may be edited. Si nce RAM A/B is non-volatile (has battery 
backup), an edited program can be saved until another stored test has to be called into A/B. 


NOTE 


As soon as the stored test program has been loaded, move the 
LOAD toggle to MANUAL. | 7 | 


5.2 Terminal ADRS — The 3270 Protocol Utilizes Three Addresses 
SPA Station poll address (e.g., to master controller) 
SSA Station select address (e.g., for device controller) 


DA Device address (for each device on the controller) 


These addresses are manually entered into the DTM program for the terminal/controller(s) under test. 


Only one device can be tested at a time with this program. Other programs can automatically sequence through 
controllers and devices for other tests. 


The program is supplied with address number 0 for SPA, SSA, DA. 


5.2.1 Station addressing uses the following sequential assignments where station number “0” corresponds 
usually to the CPU site test terminal (so it can access any ‘‘port’’): 


Number SPA/DA SSA 
0 sP 40 20 — 60 BD 
1 A cl Ct / 61 2F 
2 B C2 42 S E—2 D3 
3 6: ics: C3 T £3 54 
4 D C4 44 U £4 D5 
5 E C5 45 Vv €5 D6 
6 F C6 46 Ww E6 5/7 
7 Ger C7 X E7 58 
8 H C8 C8 Y —8 D9 
9 | cg 49 Z §9 5A 
10 [¢ 44 5B 1 6A 7C 
1 _ 4B AE , 6B 2c 
12 < 4c BC % 6C 25 


*EBCDIC (HEX), **ASCI! (ODD parity) (HEX). 
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5.2.2 ADDRESS ENTRY of the address characters into the test program is easily accomplished by 
“scrolling. Function 98 (No-Op) precedes each address entry to facilitate scrolling to the desired location. Select 
Function 98 and Data FO on the DTM panel switches, operate STEP and then UP. The program will display Step 
12 Page 0. Stroke UP once to display Step 13 for the general poll. — 


DTM Address As Supplied Enter 
Step Page (HEX) 

13 —- oO (OD) 40 SPA 
4 = #- 0 (OE) 40 SPA 


Operate UP to scroll to Specific Poll 


22 - 0 (16) 40 SPA 
23 - O (17) 40 SPA 
24 - O (18) 40 DA | 
25 - 0 (19) 40 DA 
Operate UP to scroll to Select | 
37 — 0 (25) 60 SSA 
38 - O (26). 60 , 7 SSA 
5.3 REMOTE: Test Modem 


An outline of the DTM panel is set up as referenced to Figure 5-1. 


Zone 1: Bit rate — EXTERNAL 
Sync | 
Info Bit —8 (ASCII =7) 
Parity —None (ASCII! = odd) 


Zone 2: EIA/Mil to EIA 


Power ON 
Zone 3: Control EIA to OFF 
TEST MODEM 


MON SIGS OUT TO NORMAL 


Zone 5: © RTS OFF (7x) 
CTS OFF 
DSR OFF 
RLSD OFF 
DTR ON 
Rl OFF 


Zone 6: Counter Input — Duration 8x 
Duration xxx. Milliseconds 
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EIA INTERFACE EIA INTERFACE 
AUXILIARY CONNECTOR TO CONNECTOR CONNECTOR TO 
PRINTER, CRT, TAPE, ETC. TO MODEM TERMINAL 


ZONE 8 


eeeaeeee 


T | 
A £@0e220220009008080808280 
N A 2 72 @ 6 5 8:5 & MN BOR NM , : 
Ss tO PD ATS CTS DSR AL SCT c fe 
Mw T oe SB 
3 | 3 es rc - - se Sea 08 _ 
i tT #@#ee#¢6 8 & @ e® 8 € © ¢ ee ZONE 5 
ZONE14 ™ ° DS 2 
? 8 jin oe 
A R Mom oo a 
4 o as $ ne 
A 
oe bo 
ZONE 7 
: | caste a eae | 
E @®2e-@©26820:09280 80 
ZONE 34 7 


Figure 5-1. DTM-2 Front Panel Controls and Indicators. 
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Internal Controls: Select 256-step (switch 5). The 256-step program mode is indicated by the LEFT 
hand decimal for the PAGE display ON. 


As supplied, the program controls the modem interface and measures TERMINAL response time. No 
editing is required for INTERSHAKE to test a remote terminal via a modem. | 


5.4 LOCAL: Test Terminal 


Set up the DTM panel controls is referenced to Figure 5-1. 


Zone 1 Bit rate — 4800 (or per system spec) 
Svnc 
Info Bits — 8 (ASCII = 7) 
Parity —None — (ASCII = odd) 


Zone 2 EIA/Mil to EIA 
Power — ON 
Zone 3 Control EIA to OFF 


TEST TERMINAL 
MON SIGS OUT to NORMAL 


Zone 5 RTS OFF 
CTS ON 
DSR ON 
RLSD ON 
DTR OFF 
Rl OFF 


Zone 6 Counter Input — Duration (8x) 
Duration — xxx Milliseconds 


Internal Controls: Select 256-step (switch 5). The 256-step program is indicated by the LEFT hand 
decimal for the PAGE display ON. | 


5.4.1 For FDX operation directly connected to the terminal the following proaram instruction should be 
edited. As supplied, the program controls the modem interface and measures terminal response time. 


AS SUPPLIED 
ADRS DATA FUN | EDIT 
16-2 (90) 10 73  DetRLSD OFF 02:98  NO-OP 
5.4.2 To simulate SWITCHED CARRIER, some terminals require CTS control as an active signal. The 


following program instructions should be edited. CTS toggle should also be positioned to OFF (7X). 
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ADRS DATA FUN | | EDIT : 
16-2 (90) 10 73 DETRLSD 80 73 DETRTSOFF 
17-2 (91) 80 70 RAISE RTS 40 71 DROPCTS 
19-2 (93) 40 72 DETCTS 02 98 NO-OP 
35-2 (A3) 12 83 12BITS 30 84 3SECINT 
37-2 (A5) 30 84 3SEC OC 97. ENABLE TIME INT 
38-2 (AG) OC 97. ENABLE INT 80 72 DETRTSON 
39-2 (A7) 80 71. DROPRTS 40 70 RAISECTS 
5.5 Auto Mode 


In the auto mode, the DTM operates in an unattended manner once the operator presses START 
(after setup per Paragraphs 5.3 and 5.4). 


D0. Operator sequence for the auto mode is outlined in Paragraph 4.0. If the test terminates due to a 
fault, the DTM operator may have to “‘restart’’ the test. The DTM-2 operator should, however, observe the 
INTERVIEW CRT display for any abnormalities. 


5.5.2 INTERVIEW: Each transmission sequence is displayed. Transmit is displayed. Transmit is displayed 
first (low intensity) followed by the receive (normal intensity). Refer to Figures 5-2 and 5-3. Certain characters or 
groups of characters in the receive messages are reverse imaged to call them to the attention of the operator. 


Each sequence will remain displayed for 200 ms, then the display will clear and another sequence 
appear. Edit of one step will disable the INTERVIEW CRT clear to display a screen full of transmissions. The poll 
rate of 200 ms may also be altered. Refer to Paragraphs 5.6.2 to EDIT CRT and 5.9 to EDIT POLL RATE. 


5.5.3 INTERVIEW Setup 


HDX/FDX toggle = HDX 

CODE = EBCDIC (or ASCII) 

FREEZE = RUN 

HIGHLIGHT = 00 (or ID to enhance the attribute GS characters) 
PAGE = 1 (1 + 2 for message capture) 

TOTAL SCREEN = TEXT 

CONTROL CHARACTERS = ABBREV 


5.5.4 INTERVIEW Display 
Figures 5-2 and 5-3 show the characters displayed on the INTERVIEW for the transmit sequences and 
the receive sequences. Full abbreviations are used, e.g., EOT, whereas the font displays E+. Each character in 
these figures is also presented in HEX for EBCDIC and ASCII. 
NOTES 
1, Pad character symbol is shown. 


2. Ending Pad on transmit sequences does not display. 


3 IGNORE the transmitted BCC on EBCDIC. One random 
character will be displayed after ETX. 


1-22 


SI 842-2A 


GENERAL POLL (w/RESET) 
E 
Sy Sy Sy : Sy Sy Sy 


EBCDIC 32 32 32 37 FF 32 32 32 
ASCII 16 16 16 04 FF 16 16 16 


SS 


— POLI a 
Sy Sy : G8 Sy Sy 
EBCDIC 32 32 32 i FF 32 32 32 
ASCII 16 16 16 04 FF 16 16 16 


SELECT (w/RESET) 
F 7% 
Sy Sy *¥ 0 7S Sy Sy 


/ 


EBCDIC 32 32 32 A PE Oe 32 32 
ASCII 16 16 16 04 FF 16 16 16 


RVI 
Sy Sy Sy © Z 


/ 
EBCDIC 32 32 32 10 7C FF 


ASCII 16 16 16 10. / FF 


~~PUN 


a 


Figure 5-2. Transmit Display. | 


~ ~PVUM ~™ bPUMWw 


~ rN PWM 


~~ WV 
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MESSAGE 
ce «68 E B 
Py yoy To we aan © 
EBCDIC 32 323202... MESSAGE CONTENTS - . 03 / 
ACHE TE: VE WE Oo) REFER 10 SECTION Il) PARA ge i 
ba 
Lad 
—— 
© 
= 
ty 
ECHO ENTER ; 
a E 8B 
X C¢ 
EBCDIC 32 32 32 =. = F5 FI oe 03 FT 
ASCII 16 16 16 02 98 BS 31. . . . eee 03 
CONTENTS OF 3270 CRT THAT 
ARE MODIFIED ARE RECEIVED 
AND STORED IN DTM MEMORY 
WITH THE ADDRESS OF EACH 
FIELD. 
INDIVIDUAL FIELD ATTRIBUTES ARE NOT ECHO'D. 
ALD ECHO 
S E D E 
S,SYy TS G S G Sc G / T 
Mies eee ee 2s el. 2 a 2 x 


EBCDIC 32 32 32 02 27 Fl F2-1D 61 40 Cl C9 C4 1D E9 / 40 13 1D 61 03 
ASCII 16 16 16 02 9B 31 32 9D 2F 20 C1 49 C4 9D DA / 20 13 9D 2F 03 


* AID CHARACTER RECEIVED FROM 3270 AND STORED IN DTM MEMORY. 


Figure 5-2. Transmit Display (Continued). 
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FOT (NO TRAFFIC) 
E 

Sy O 
EBCDIC 32 37 FF 
ASCII 32 04 FF 


*% Device Available 


BCC Error (3275) A SP 
Device Not Available 


WS 


STATUS AND SENSE Goo 


S Ss S SJE BY 
S ° D 
y 0 T P s silt c 4% 
5 AIR YE a 21x € # 
EBCDIC 32 01 6C D9 02 / / / Jf O03 / FF 
ASCII 16 01 25 52 02 / / /f/ Jf 83 / 


AID REPLY - ("PF" KEY = LONG READ) 
y EERE SC Pee MODIFIED DATA ON ECg 
xr A? A, Aa © A, A> CRT DISPLAYED HERE XC Yt 
EBCOIC. 32°02 J ff f f £ TV Ff f @ we «@ & & = & OBS CFF 
ASCII 16 02 / / / / /.91 / J . iw & 83 / FF 
CURSOR SET BUFFER ADRS FOR | 
LOCATION EACH DATA GROUP 
AID REPLY - ("PA" AND "CLEAR" KEY = SHORT READ) 
Ss Ss E BZ 
S D Yo ee 
Y T P t. coy 
x a A i X CF 
EBCDIC 32 02 / / O63 EF 
ASCII’ 16 02 ¥ -~ ¥ 83 ~ -FF 


Figure 5-3. Receive Display. | 
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ACK 0 ACK 1 


D Y, D Y, 
; S 
EBCDIC Sy 3 “ EBCDIC Y ; “ ig 
32 10 70 FF | 32 10 61 FF 
D / | D / 
S pe S. ip 
ASCII Y 7 O “ es ASCII « “ | Y, = 
16 10 BO FF 16°10 3% FF 


<M 


EAE: 
8 UK| 
EBCDIC 32 O17 6C 61 O02 11 
ASCII 16 O01 25 2F O02 91 


cia EACH MODIFIED. 
FIELD ON CRT ——-—————— 


SS 


* 


~~-—>D 
~ Nf pW 
~ ~OOODW 


WwW W 
m2 ~67 
7 ~6”7 


NAK (3270 ONLY) 


WV) 
~< 
APPZ 


EBCDIC 32 3D FF 
ASELT (6 10: FP 


** NON PAD characters observed after one or more PAD symbols in the TEST MODEM 
configuration usually indicates that the receive modem may be strapped for ‘’1-second 
holdover’’ or some combinations of “‘new sync” or “‘soft carrier turn off.”” Any 
pulses observed on the data leads will show up as ‘‘garbage characters’’ and may 
cause transient operational problems on the system, Normally when the receive 
signal terminates, RLSD will clamp the Rx lead mark (or in new sync... . the clock 
will be clamped). 


Figure 5-3. Receive Display (Continued). 
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4. RECEIVE CHARACTERS ARE BRIGHTER than transmit 
characters. 


5. The first 2 SYNC characters in a RECEIVE sequence are 
“absorbed and are not displayed. The sequence shows one 
SY displayed depicting a circuit containing 3 SYNC 
characters. 


6. All transmit characters are displayed (including SYNCS). 


Ti Reversed characters on the CRT to highlight specific receive 
sequences are boxed [1] 


8. The received BCC on EBCDIC is comprised of two 
characters. The received BCC on ASCII is only one 
character. 


9. Refer to Section !!, Paragraph 4.0, for description of the 
“non-protocol’’ character sequences in the message for 
control of the 3270. 


5.6 Interactive Mode 
In this mode, operation of the test is a coordinated interaction between the 3270 operator and the 
DTM operator. For diagnostic purposes, the DTM operator releases each DTM transmission manually and 


instructs the 3270 operator to perform specific key tasks associated with the fault condition. 


5.6.1 Operational sequences outlined in Paragraph 4.0 can be used as a guide; however, the flow chart 
shows that certain steps can be repeated or deleted to more quickly focus on a problem. 


5.6.2 Displayed data will be the same as shown in Paragraph 5.5.4. The data will remain for up to 3 seconds 
unless the STEP button is operated to release the next transmission. After 3 seconds, the terminal will time out 
and initiate an ENO to which the DTM will respond with a reset and General Poll. 


The operator may at any time manually freeze the INTERVIEW display. 


To obtain a full screen of data, the CRT CLEAR can be edited to disable. 


ADRS DATA FUN EDIT 
13-2 (8D) 01 94 Clear CRTON....... 02-98 NO-OP 
5.7 Time Measurement 
5.7.1 Terminal Response time is measured (as the program is supplied). The measurement begins at the end 


of the transmit sequence and ends after the. first NON-SYNC character that is received. The time, therefore, 
includes all system parameters: Modem, Ending PAD, leading SYNCs and one data character. Exact timing for 
each transmit sequence is shown below. Note that the delay between the last transmit character and activation of 
RTS is related to the bit rate. | 


Response time measurements will be encountered from 10 ms to 800 ms depending upon the 


terminal vendor, error checking techniques, buffer transfer method, etc. This is an important system parameter to 
advise the user. | 
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4 
POLLS: : 
ENO Sits 
RVI: 4s 
BITS 
MSGS: BCC, 2 
, BITS 
RTS 


OFF 


Ss .E 
Sy Sy Sy T § MSGTEXT 


REC CHARACTERS 
FIRST NON-SYNC CHARACTER 
5.7.2 RTS-CTS Delay Measurement may be accomplished by editing two steps in the program. 
AS SUPPLIED FOR RTS/CTS TIME 
ADRS DATA FUN | EDIT TO 
18-2(92) 02 98 NO-OP.......... 01-87. _ Start Timer 
36-2(A4) 01 87 Start Timer...... 02-98 NO-OP 


e Select counter to “Duration (8x) 


e Select range to the appropriate delay anticipated, e.g., xxx milliseconds or xx.x 
milliseconds if the maximum delay is expected to be less than 100 ms. 


5.8 Endurance Test 


The test returns normally to a general poll after completion. A simple PASS-FAIL endurance test can 
be implemented to repeat blocks up to 108 times. By editing only six steps, the DTM will write a predetermined 
number of alternating blocks of data to the 3270 and verify the ACK 0, ACK 1 response. An erroneous ACK 
response will stop the test. Using the front panel counter to select the number of received ACKs, the endurance 
test can run for 10 to 108 blocks. For example, the test will stop automatically “END” when 10% blocks are sent 
or when an incorrect ACK occurs. Actually every transmission is included in the block count so that the 
ENDURANCE test can be run only with polling. Operate the counter reset key on the DTM when the “form” is 
echo’d to restart the counter to count only ACK responses. _ . 
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Editing of the program is described below: 


AS SUPPLIED 

ADRS DATA | FUN EDIT/ENTER 
18-2 (92) 01 87 (EDITED) 02 98 NO-OP 
36-2 (A4) 01 87 (EDITED) 02 98 NO-OP 
38-2 (A6) OC 97 ENABLE INT OB 97 END=INT 
43-2 (AB) 08 97 DISABLE INT 00 85 ADVANCE BASE COUNT 
27-3 (DB) 00 41 PRESET 55 41 PRESET ECHO ENTER 
00-0 (00) 50 47 MSG=0 7F 40 JUMP TO END 


@ Select counter to “EVENTS IN 10%”. 


e Select counter range to 10° and test will stop after 1000 transmissions from the 
terminal. 


Displayed during the endurance test will be the ECHO ENTER message (which begins with an 
erase/write) followed by END OF TEST (which begins with a write). The overall result will be a flickering END 
OF TEST message because it is erased during ECHO ENTER and must wait one Poll Rate delay to be displayed. 
Visual effects differ according to the poll rate and whether the 3270 is buffered or not. The operator is able to 
observe that the test is in process — and the keyboard of the 3270 will be locked out. 


The terminal must calculate the BCC and check it before the ACK response is generated. This will 
exercise the terminal logic rather well. Depending upon the manufacturer's design, a variation in response time 
may be observed, since one message is longer than the other. 


Termination of the endurance test is described to stop at END; however, it could be edited to resume 
with the general poil. 


5.9 Poll Rate 


The program is supplied with a 200 ms poll rate. The poll rate is determined by a delay between the 
last received character and the beginning SYNC character transmitted by the DTM. After the delay, the 
INTERVIEW CRT is cleared so that the next transmit-receive sequence is displayed. Adjustment of the poll rate 
is achieved as follows: 


AS SUPPLIED 
ADRS DATA FUN EDIT/ENTER 


02-98 NO-OP = MIN* DELAY 
12-2(8C) 02 82 200 ms..... 30-82 3SEC=MAX DELAY 
00-00 Manual Halt 


“Total delay is obtained by adding three delays in the program: 


ADRS 
10-2(8A) 15 ms “Beep” for each transmission 
12-2(8C) — ms Pol! RATE 
14-2(8E) 2 ms Clear CRT screen delay 


17 ms MINIMUM 
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The operator may desire to ““NO- op” all three delays under special test situations to simulate ‘‘zero 
turnaround delay by the CPU”. 


5.10 Program Termination 
After the message is ECHO’d back to the 3270 display with “END OF TEST”, the normal program 
returns to a general poll and leaves the 3270 keyboard locked out. The test may be repeated by operating the 


RESET or LOCAL key. 


By editing one step, the program can terminate with END or automatically alternate two blocks for 
an ENDURANCE test. The ENDURANCE test is described in Paragraph 5.8. 


Terminating the test with END shuts down communication with the terminal in an orderly fashion by 
sending EOT to the 3270. The 3270 will be inoperable because DTM polling will cease. Restarting the program is 
accomplished by operating START on the DTM. 

5.11 Audible Status Indication 

After each response is received from the 3270 (toa DTM transmission), an audible BEEP is produced. 
This chirp lasts 15 ms and contributes to the delay between receiving the last character of a 3270 message and 
initiating the response transmission by the DTM. The volume of the beep is not controlled by the DTM volume 


control, but it may be shortened. 


AS SUPPLIED | 
ADRS DATA FUN EDIT/ENTER 


04-80 “TICK” sound 


10-2(8A) 15 80 15ms....... 02-98 NO-OP deletes beep 
| [99-82 9.9 seconds maximum 


6.0 REFERENCE DOCUMENTS 
6.1 Industry Sources 


Numerous documents are available covering the BI-SYNC protocol, and other communication 
techniques. A few of these documents are referenced for the aid of the reader. 


General Information — Binary Synchronous Communications IBM # GA27-3004-2 
IBM 3270 Information Display System Component Description IBM # GA27-2749-6 
Operators Guide for IBM 3270 Information Display Systems IBM # GA27-2742-4 


SYSTEM OPERATION FOR SYNCHRONOUS MODEL 40/4 DATA TERMINAL 
Teletype Corporation, Technical Reference Part 2, Article 7 


EIA RS-232 

6.2 ARC Documents | 
DTM-2 Operator's Manual, OM842 
INTERVIEW Operator’s Manual, OM860 


DTM-2 Function List Folder, TP-148-3-77. 
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AS SUPPLIED 
ADRS — DATA — FUN 


TEST MODEM 


16-2(90) 10-73 DET RLSD OFF 


Test Modem (Remote) 
e.g., switched Carrier 


Select Test Modem 
EXT Clock 


DTR ON 


RTS OFF (Auto) 


ADRS 


16-2 (90) 
17-2 (91) 
19-2 (93) 


35-2 (A3) 
37-2 (A5) 
38-2 (A6) 
39-2 (A7) 


AUTO MODE 


12-2(8C) 02-82 200 ms POLL DELAY 
= Auto Mode 


CLEAR CRT DISPLAY 


13-2(8D) 01-94 Clears CRT 


DATA 


10 
80 
40 


12 
30 
OC 
80 
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Table 5-1. Edit Options. - 


(FDX) 


(SWITCHED CARRIER) 


FUN 


73 DET RLSD 
70 RAISE RTS 
72 DET CTS 


83 12 BITS 

84 3SEC 

97 ENABLE INT 
71 DROP RTS 


before each DTM-2 transmission 


TIME MEASUREMENT 
MEASURE TERMINAL RESPONSE 


18-2(92) 02-98 NO-OP 


36-2(A4) 01-87 Start Timer 


to begin to measure time from 
Last Transmitted Char to 3270 Reply 


BEEP 


10-2(8A) 15-80 15 ms Beep ON Time 


15 ms beep occurs before each 


transmission of DTM-2 


EDIT 


80 
40 
02 


30 
OC 
80 
40 


ee 


* 8s 86 » @ @ © © @ © 8& ©@ He FH Oe He Fe FH we He HB 


EDIT/ENTER 


TEST TERMINAL 


02-90 NO-OP 
Test Terminal (Local) 


- Select Test Terminal 


Select Speed 


DSR, RLSD ON, CTS ON 


DET RTS OFF 
DROP CTS 
NO-OP 


3 SEC INT 
ENABLE TIME INT 
DET RTS ON 
RAISE CTS 


INTERACTIVE MODE 


00 - 00 Halt = Interactive 
mode. DTM-2 operator releases 
each DTM-2 transmission manually. | 


CONTINUOUS DISPLAY 


Ce ee ee 2 | 


Ce ee ee 


02-98 NO-OP for continuous 
display a, 


RTS-CTS DELAY 


01-87 Start Time 
RTS >CTS 


02-98 NO-OP - 


04 - 80 = “Tick” 
Variable to suit user 
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Table 5-1. Edit Options (Continued). 


AS SUPPLIED 
ADRS — DATA — FUN 
ENDURANCE TEST 
(SWITCH CARRIER) (Continued) 
ADRS DATA FUN | EDIT 
18-2 (92) O01 87 (EDITED) 02 98 
36-2 (A4) 01 87 (EDITED) 02 98 
38-2 (A6) OC 97 ENABLE INT OB 97 
43-2 (AB) 08 97 DISABLE INT 00 85 
27-3 (DB) 00 41 PRESET 55 OT 
00-0 (00) 50 47 MSG=0 7F 40 
POLL RATE* | 
12-2(8C) 02-82Delay....... cece cece eee eee sees Saheaeenes 
prior to DTM-2 | 


_ transmission = 200 ms 


PROGRAM TERMINATION (after “End-of-Test”) 


 27-3(DB) 00-41 Preset... 0c, cc cee ce creer acc ece eer eneeeenn 


to START/GEN POLL 


27-3(DB) 00-41 Preset... .... cece cece eect peer t ete ve eens 


to START/GEN POLL 


EDIT/ENTER 


ENDURANCE TEST 


NO-OP 
NO-OP 

END = INT | 
ADVANCE BASE COUNT 
PRESET ECHO ENTER 
JUMP TO END 


— Select Counter to “EVENTS in 10%” 
The interrupt on time out is disabled; 
therefore, the 3 sec. timer is not 
operable in the DTM. A failure of 
the 3270 to reply will cause the 
program toHALT. = 


— Select Counter Range to 10° and 
test will stop after 103 Blocks 
(longer or shorter tests may be 

selected 10N) ~ 


VARIABLE RATE 


30 - 82 is max delay of 3 sec. between 
responses. Unless interactive mode is 
selected. 


ECHO ENTER alternates with 
END OF TEST . 


55-41 Preset Echo Enter Alternates 

2 messages for ‘‘Endurance” Test 
(Checks ACK 0- ACK 1 Response ... 
Stop by DTM-2. Keyboard of terminal 
is locked out) | 


END 


7F - 41 End Terminates Test. 
DTM-2 Restarts Test. 


*For total delay, add the delay at 3 address: 8A + 8C + BE. (Refer to paragraph 5.9). 
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SECTION I! 


DTM-2 PROGRAM 


1.0 PROGRAM DESCRIPTION 


The DTM program consists of several ‘‘program modules’. Each program module treats a specific part 
of the protocol. There are two major types of modules: Receive and Transmit. 


One single concept is the key to this program: All received signals are first processed by the ‘“REC 
Module’. After the REC module identifies the type of message being received, two further decisions are 
performed: 


a. Is this the correct response to the last transmit message, and 
b. What is the next transmit message to respond to this received message? 


A second key ingredient in this program is the use of a transmit subroutine which contains all the 
“housekeeping’’ chores to control the RS-232 interface modem, Interview CRT, time delay measurements, 
polling delays and operator interaction. This subroutine is common to (precedes) all transmit sequences and 
includes SYNC characters, etc.). 


A third key concept is the use of the fact that since all transmit modules are followed by the REC 
module, the factors normally considered “transmit shut down” can be assigned to the REC module. These 
features: delay after the last transmit character prior to controlling the RS-232 interface leads, time delay 
measurements, Interview CRT control, etc., occur only once... .in the REC module. 


2.0 PROGRAM MODULES 


Figure A shows a Program Module Flow Chart. This flow chart shows the linkages of the major 
program modules relative to their inputs and outputs. JUMP instructions are used to direct the program flow 
between these modules. 


This technique of using modules substantially simplifies the understanding (and writing/debug) of 
otherwise complex programs. Each module is written as a stand-alone program and is then incorporated into the 
overall program as determined by Figure A. 


How big a module should be depends upon the purpose of the module. Note that the REC module in 
Figure A generates several Outputs directly controlling send modules. There is, however, further processing of the 
DLE by the ACK module and further processing of SOH and STX by the S&S and AID module. Generally a 
module should have a defined input (or two) and a well-defined exit point (or several outputs). 


Comparison of the Program Module Flow Chart in Figure A to the Interactive Flow Diagram in 


Figure A-1 will reveal a similarity. Figure A is oriented toward the program in the DTM and Figure A-1 is related 
to using the DTM program to generate the protocol sequence required to the 3270 terminal. 
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RECEIVE MODULES SEND MODULES 
| ] 


START = RESET & 
GEN POLL 


SELECT 


RESET & 
SPEC POLL 


Figure A. Program Module Flow Chart. 
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INTERSHAKE TERMINAL 
TRANSMITS TRANSMITS 
GEN POLL 
® 
sas 
avi @) 
cot 
SPECIFIC POLL 
EOT 
G2  sa&srotst © Pe 
(o) ECHO ENTER (11) 
AID ECHO MSG FORM 
9 
ACK 2 
MSG =0 ROTST=0 
ENTER = 1 
7 MSG= 1 
© __Rorst=1 ROTST= 0 
SELECT 
ACK 0 
MSG = 0 


(12) BAD MSG 


(3275) (3275) (EOT) | 


NAK 
(3270) 
GOOD MSG 
MSG = 1, ENTER = 0 ACK 1 
ROTST =0 
DOTS TO 
“END OF TEST” 
ACK 0 
EOT 
START 
MSG = 0 


Figure A-1. Interactive Flow Diagram. 
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NOTES 


ON POWER UP. 


NO PENDING S&S. 


RESETS S&S. 
RESPONSIVE TO RVI. 


ERROR RESPONSIVE. 
(S&S PENDING) 


ROTST KEY OPERATED. 


ANY OTHER AID KEY 
OPERATED. 


NO TRAFFIC. 


ACK 1 RESPONSE SINCE 
AID/ROTST RESPONSE 
GEN POLL EQUALLED 
ACK 0. 


ECHO ANY AID KEY AND 
“ENTER” ON TO FORM 
BAD CRC E.G. STATUS 
LED WAS ON. 


ECHO “ENTERED” DATA 
ON GOOD FORM. 


3275 AFTER BAD MSG 
HAS BEEN SENT. 


AFTER GOOD MSG HAS 


BEEN SENT (AND ACK 1 
RCVD). 


FLAG STATUS 


START SETS ALL FLAGS TO “0” 
ROTST: SET OON SEND ENQ 


SET 1ON REC ROTST 


BAD MSG TOGGLES: “0’’ FOR BAD MSG 
MSG: 0=SELECT GEN POLL. 


ENTER FLAG: 


1 = GOOD MSG 


0 ———© SEND ENO 
1 —— REC ENTER 


S&S: 0OON SEND ENO 


1 ON REC S&S — 
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A further study of the individual program modules wil! indicate the sequential protocol criteria for 
decisions that are not labeled in Figure A, but implied in Figure A-1. 


Figure A-2 shows the flow chart symbols used in the program modules. There are four major program 
criteria: (1) input/output, (2) actions, (3) conditional tests/JUMPS, (4) subroutines. | | 


2,1 Receive Modules 


There are three receive modules. Figure B-1 shows the REC module which is basic to the entire 
program concept. Note that there are a number of actions related to terminating the transmit operation prior to 
actually beginning to receive data. Processing of EOT depends upon the status of the S&S flag. 


Figure B-2 shows the ACK module. This is perhaps the most complex module, since it both tests for a 
valid ACK 1-0 sequence and also determines where in the operational sequence (Figure A-1) the program is. 


One of the prime features of the DTM-2 is the availability of 8 flags. These flags are set to ‘’1"’ or “0” 
at various stages of the program and can be tested at any time to determine whether an action has or has not been 
previously taken. | 


Note that the termination of the test (right most path) can be edited from the General Poll to Echo 
Enter or END as shown by the dotted lines. 


Figure B-3 shows the S&S and AID module. These are really two modules; however, they both share 
many common features and are joined to conserve program steps. | 


The S&S path sets flags denoting S&S or ROTST and controls the Interview to Reverse image to 
highlight this important character sequence for the operator. | 


The AID path and ROTST logs the AID character into a predetermined location of Results Memory 
so that the same character received from the 3270 will be echoed back to the 3270. 


“Enter” aid must also be flagged to properly echo the data manually entered in the ‘’form”’ on the 
3270. Figure B-2 shows the ACK 1 path testing the enter flag so END OF TEST can be generated. 


2.2 Transmit Modules 


There are 8 basic transmit modules. The “Start TX” subroutine and “END”modules do not show up 
on the overall Program Module Flow Chart in Figure A because they are common to many segments of the 
program. 


Figure C-1 shows the START TX subroutine. This subroutine is used for all transmit modules. All 
start-up controls are included in this subroutine for RS-232 control, time delay measurements, Interview CRT 
control, audible alert to the operator that a message was received, and operator interaction, e.g., HALT and poll 


rate. Most of the EDITING for various features is performed in this part of the program. 


START TX has the primary function of generating 3 SYNC characters that start each transmission. 
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——— ENTRYOREXIT — START, HALT, END 


ANY SIZE E TURN ON RTS 
RECT OR SQUARE ACTION STATEMENTS SEND CHARACTER 
START TIMER 


~ SUBROUTINE RETURNS 
CALL SUB ROUTINE HERE UNLESS OTHERWISE 
STATED 
(SEE SECT. III, PARA. 11) 


JUMP (CONDITIONAL) JUMP =ENQ 
<> aie RETEST & JUMP = DLE 


Figure A-2. Intershake Program Flow Chart Symbols. 


2-5 


SI 842-2A 


SET RM PAGE 0 X pels ee 
| | TRANSMIT SEQUENCE 
WAIT N BITS COMPLETES HERE 


| 
ENABLE INTERRUPT TIMER 


TURN OFF RTS 
I 
CRT LOW OFF 


WAIT # SYNC 
DISABLE INT | 


018+ 
CS can 
. 6 


(END) GEN POLL SPEC POLL 


_ Figure B-1, Receive Module 
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# = “ACKO"” 


RT&J 
END = 61 


WACK/RVI 


ACK (ACK ERROR) 


GEN POLL 


* 


ECHO ENTER ) 


*EDIT OPTIONS 


— SPEC POLL END OF TEST 


SELECT | 


Figure B-2. ACK Module. 
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S| 842-24 
REC moe LE 


/ AID FROM 

. REC MODULE 

| STARTBCC | 
| WAIT 2CHAR 


_| SET S&S 
| FLAG=1 


| SETENTER 
| FLAG=1 


| CRT REV OFF Kee 
| LOG TIL ETX | 


Cael 


(_AIDECHO 


Figure B-3. S&S and AID Module. 


(ECHO ENTER 
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POLL DELAY 


OQ 
5 
53 
~| 
A A A A 


DET RLSD OFF 


RTS ON 


MEASURE <j 


RTS/CTS DLY NOTE 


1) GENERAL FORM IS SHOWN 


RM PAGE 0 2) <j SYMBOL DENOTES 


PROGRAM VARIABLE - 
EDIT 


CRT LOW 3) SEE “EDIT” FOR 


INSTRUCTIONS 


SY, SY, SY 
= 1 = 0 SENT 
<> RETURN _) (sy sy SY) 
EOT. PAD 
SY, SY, SY 


SET R=0 


—2( RETURN pel 
(SY SY SY EOT PAD SY SY SY) 


Figure C-1. Send Module Start TX (Subroutine). 
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A capability is included to lengthen the subroutine (e.g., chain onto it another sequence of characters 
to the transmitted). By testing the R (return) flag, the RESET sequence used by General Poll, Specific Poll and 
the Select sequence is added to the Start TX only when needed. 


Figure C-2 shows the modules that require the 3270 address characters. This chart indicates how 
portions of transmit programs that are common can be shared to reduce program steps. 


After the ENQ, a number of flags are initialized. The receive modules may then test these flags for 
status (e.g., was the last transmission an ENQ..... and which one?). 


Figure C-3 shows the generation of the messages having textual content. 


An important feature is the alternating Good-Bad BCC for the message (form) sent to the 3270 at the 
request of the ROTST key. The E (error) flag keeps track of the status of good or bad BCC. 


Several steps are saved in the program by common use of ETX and BCC. 

Figure C-4 shows the three “canned” responses: RVI, END OF TEST, and END. END sends EOT to 
reset the 3270, then shuts down the DTM operation, leaving the INTERVIEW display showing the last 
transmit/receive sequence. 

2.3 Module Linkages 

This program is comprised of several smaller program modules. Table A includes receive, transmit, 

and other modules to describe the overall character of the program. Table A shows important characteristics of 


each module such as: 


e Starting address (in Hex since Jumps use the Hex address) 


& Module size (to show during program development how big the overall program 
is....and where to place the module in the overall program) 
e Exit (what other modules the program may jump to as it continues operation) 


e SET flags (which flags are set in the module) 


TEST flags (which flags are tested in the module) 
3.0 PROGRAM LISTING 


The program listing is contained in Appendices A and B. EDIT DATA or FUNCTIONS are within ( ) 
brackets for ease of location. 


This test is contained in a 256-step program cell. Fourteen steps are unused and are available for 
special purposes the user may define. One example is to cause the results memory contents to be transmitted to a 
printer, e.g., ASCII at 110 Baud using code conversion from EBCDIC. Figure 4-3 contains a record of the test and 
would be available at the DTM site as well as at the 3270 site (if the site is so equipped). This exercise is left to 
the user. 


Each program module is separated by heavy horizontal lines and is titled within a circle near the 
right-hand JUMP arrow column. 


Figure D shows the program listing as displayed on the INTERVIEW. 
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GEN POLL SPEC POLL SELECT 


7 _ R FLAG =1 
R FLAG=1 R FLAG = 1 eG 
START 
TX 


SPA SPA SSA 
| 
‘ DA 


_ ENG NOTES 


1) RFLAG=1CAUSES 
START TX SUBROUTINE 

SET FLAGS TO INCLUDE RESET (EOT) 

ACK = 0 AND THE NEXT SET OF 

ROTST =0 SYNCS FOR POLL. 

ENTER =0 REFER TO START TX 

S&S = 0 SUBROUTINE. 


2) “REUSE” OF DA AND ENQ 
BY GEN POLL & SELECT 
RECEIVE SAVES PROGRAM SPACE. 


Figure C-2. Send Poll & Select Modules. 
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C Msc) AID ECHO ECHO ENTER 
START START \ START 
TX \ TX \ TX 
| STX | STX STX 
| startecc | © | STARTBCC 


~vrite” | | “ERASEWRITE” 


TEXT (AID) 


‘SEND RM 
THRU ETX 


| EFLAG=1 


E FLAG =0 | SEND RM 
— (AID CHAR) 7 
MSG FLAG = 1 FIG. 4.3 


START 


BCC START 

BAD BCC 
“FORM” OK 
FIG. 4.2. 


(MSG ETX) | FROM END | 
OF TEST 


[x] 
a 


Figure C-3. Send Modules: MSG, AID, ENTER. 
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WAIT FOR (FF) 

END OF 

RECEIVE 
TRANSMISSION 


“WRITE” 
TEXT 


MSG ETX 


Figure C-4, Send Modules: RVI, END OF TEST, END. 
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WLAG 


Start ADRS 


1. SEND/TRANSMIT 


09 
12 
20 
28 
2E 
3F 
55 
5F 
7F 
89 


2. RECEIVE 
A2 


BA 


E7 
D3 


FD 
* Flags Set 


Title 


Reset & Gen Poll 
Reset & Specific Poll 
Reset & Select 

RVI 

MSG 

Aid Echo 

Echo Enter 

End of Test 

End 

Start TX (Subroutine) 


Receive 


Start Up 


Interrupt Service 


Table A. Program Modules, Linkages, ADRS, Flags. 


# Steps 


20 


ROQOTST = 0, Return = 0, Enter = 0, S&S = 0, R Flag = 1 


Exit 


REC 
REC 
REC 
REC 
REC 


MSG ETX 
MSG BCC 
MSG ETX 
Stop 
(Return) 


S&S, AID, ACK MSG, 
GEN POLL, SPEC POLL 


RVI, AID ECHO, 
ECHO ENTER 


S&S — 


_ SELECT, SPEC POLL 


END OF TEST, MSG, 
GEN POLL/ECHO/END 


GEN POLL 
GEN POLL, START 


Set Flags 


* 


* 


* MSG = 0 


E Toggles | 
Good MSG = 1 


ROTST = 1 
S&S =1 


Enter = 1 


“ACK = 1ACK =0 


MSG = 0 


Test Flags 


S&$& 


ACK, ROTST 
MSG, ENTER 


Vz2-2v8 IS 
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For the convenience all addresses which are used as destinations for Jumps are circled. Major program 
features are listed under comments. 


There are only two differences between the EBCDIC and ASCII programs: (1) code for characters 
and (2) BCC. Functions 38, 39, 58 and 59 are related to the BCC change from CRC (EBCDIC) to LRC (ASCII). 
Fill characters are not required for LRC and are deleted in ASCII. 


3.1 EBCDIC 

File DO1 describes the EBCDIC test. 
3.2 ASCII 

File DO2 describes the ASCII test. 


For ASCII, the program is set up for ODD parity characters and EVEN LRC. The program checks for 
Parity errors as well as for LRC errors on all transmissions. A parity error will register on the PE LED but will be 
counted only if the counter is manually selected to PE in 10% and the timer Functions 87 are edited to NO-OP 
(at Hex address 92, A4). 


3.3 Program Display 


Figure D-1 shows the INTERVIEW display of the INTERSHAKE program (EBCDIC) in the LOAD 
mode. A horizontal presentation permits the text to be directly read. Program Characteristics are easily noted: 


a. One program sheet lists 32 steps which correspond to one line on the CRT. All 256 
steps are displayed. | 


b. The top and odd lines contain the Data and the Low intensity line shows the 
_ corresponding Function. Step 01 contains Data 2D and Function 19. 


Cc: Steps contain Data transmission character oriented functions are normal (White on 
Black). 2D in Step 01 is directing the receiver to look for an ENQ character. 


d. NON data or character oriented functions are displayed Reverse image (Black on 
White). Step 31 is a JUMP instruction to Address A2 Function 40. 


e. The Highlight switch is selected to 1D (Hex) to visually identify all GS (start 
‘attribute field) characters in the program. The Highlight switch could also enable 
the operator to see every step in which a specific function is used in the program. 


f. All Control characters can be easily highlighted by operating the ‘control 
characters = HEX”’ toggle on the INTERVIEW. Figure D-2 shows control characters 
in HEX. Note that SY (SYNC) and GS in Figure D-1 changed to 32 and 1D in 
Figure D-2. 


3.4 Program Printout | 
| When equipped with INTERKEY, the INTERSHAKE program (EBCDIC) may be printed on any 
ASCII, ASYNC printer. Figure D-3 shows a typical printout with the title manually entered. This program 


example has an Identifier character “A” prior to the “G” (Go) header character. This identifier is assigned to 
assist in retrieval of a specific program from a tape file containing many programs. 
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Figure D-2. Program Listing on INTERVIEW (Hex Control Characters). 
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Figure D-3. Draft Listing Using Inter-KEY. 
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Several important characteristics should be noted: 


a. Each column contains 32 steps corresponding to one side of a standard program 
sheet. | 

b. Each column is separated into 4 groups of 8 steps to facilitate locating/counting 
steps. 

C Eight columns correspond to 8 sheets or a full-cell test of 256-steps. 

d. An entire 256-step program will fit on a single 8%” x 11” sheet of paper for ease of 
filing. 

e. Printout of Data and Function is a readable format in the same form as the Program 
Sheet permitting easy transfers from Printout to Program Sheets or vice versa. 

f. All characters are printable, even for contro! characters; therefore, the program can 
be listed on any Printer and may even be sent over a TWX network. 

g. | Thecharacter after the last ‘‘S” is a BCC check and may not print. 

4.0 MESSAGE TEXT 


Figure E shows the text of the message “FORM” transmitted by the DTM to the 3270. Figure 4-2 in 
Section | shows this form. Each character is presented several ways, including the purpose, symbol, EBCDIC HEX 


and ASCII HEX. 


The user should consult the reference documents listed in Paragraph 7 of Section | for specific 
definitions. A brief description of the control character sequences used follows: 


ERASE/WRITE = “ESC 5”. The 3270 terminal will reset the buffer address to 
home after erasing the display. Unless specified, the first character will be written at 
the home location. 


WRITE = “ESC 1”. The 3270 will display the next received character where the 
cursor is manually positioned on the screen or at the next location from the last 
character written to the screen. 


SBA (Set Buffer Address) = ““DC1 ROW COL”. The two characters following DC1 
define the row (1-24) and column (1-80) where the next character will be written. 


START FIELD = “GS Char”. The (attribute) character following GS defines the 
characteristics of all characters written on the screen beginning at the next address 
and ending at the next GS. The attributes ‘“wrap” around the display screen and 
can be used to generate various visual effects when writing on NON-BUFFERED 
terminals. 


The selections for attributes are: Protected (e.g., operator cannot change the character displayed), 
Hidden (e.g., the character is present but not displayed such as privacy of security information codes), Blink 
(character blinks), Highlight (character is brighter than normal, Numeric (character can only be digits, minus and 
period) or Modified (a modified character is available to be transmitted from the 3270 to the CPU... . generally 
all operator-entered fields are modified). 
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Figure E. Message Form. 
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® RTA (Repeat to Address) = “DC4 ROW Col Char”. This instruction causes the 


character to be repeated from the present buffer address to one /ess than the 
specified row and column. Printing dots through column 70 would place a dot at 
column 70 and the column specified would be column 71. 


e WRITE CONTROL CHARACTER. The first character after ERASE/WRITE or 


WRITE identifies the characteristics applicable to the write operation. These 
characteristics start the printer, sound the terminal audible, place the terminal 
keyboard in local (if not in local, the keyboard is locked out and not available to 
the operator), and defines the character fields entered by the operator (or prior 
CPU action) as available for transmission from the 3270 to the CPU. 


FLAG ASSIGNMENTS 


One key to this program is its ability to know what happened last ....in order to determine if an 
error was made,,,, and to determine what happens next. As the program operates, it sets various one-bit memory 
latches called flags to either 1 or O. There are 8 such flags available to the DTM user. Seven of these flags are used 
in this program. All flags are initialized to “‘O” by the DTM START switch. 


FLAG 0 — The RETURN (R) flag “0” presets the subroutine exit point to generate only 
three syncs (or to “1” to include the reset sequence). 


FLAG 1 — The ACK flag keeps track of whether the 3270 should reply with ACK O or 
ACK 1. This flag is tested to determine if an out of sequence ACK is received. The 
endurance test checks this flag to define an error. 


FLAG 2 — The S&S& flag is set to 1 for an S&S message received, e.g., on 3270 power-up, 
and causes the General Poll to continue until all device status is in or to start the Specific 
Poll after all device status is in. 


FLAG 3 — The ROTST (Request Test) flag is set to a 1 for receipt of the RQTST message 
from the 3270. This flag causes the transmission of the message form to the 3270. 


FLAG 4 — The ENTER flag is set to a 1 by receipt of the ENTER AID. The combination 
of ENTER and MSG and E tells the DTM that the operator has entered data into a good 
message and that ECHO ENTER is the next transmit module. 


FLAG 5 — The MSG (Message) flag is set to 1 when the message form is sent to the 3270. 
FLAG 6 — The E (Error) flag is set to 1 for a good BCC. This flag alternates beginning 
with a Bad BCC. The 3275 terminal requires the ROTST key request the form bad, then 
good, etc... The 3270 ROTST will always call a Bad BCC first, then the NAK will always 
automatically call the Good BCC. | 


FLAG 7 — Not used. 
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SECTION II! 


PROGRAMMING HINTS 


1.0 SEQUENCE OF WRITING A PROGRAM 


The following method is recommended to more quickly generate programs, to reduce errors and 
provide documentation for operation, debug, and future changes. 


The process is iterative, that is, certain aspects are repeated and updated as the program matures. 


Each user will find individual preferences and techniques that are comfortable. This outline is 
provided as an aid especially to the beginner. Experienced programmers will have already developed their own 
“system”. 


1. Write a sequence of operation as shown in Figure 4-1. There should be columns 
headed: 


DTM — Operations of the DTM, e.g., Send Data 
Terminal — Operations of the Terminal/CPU, e.g., Send 
Terminal Operator — Operator tasks at the terminal 


DTM Operator — Operator tasks at the DTM, e.g., observe display, operate a 
key. 


2. Consolidate the sequence of operations into a Program Module flow chart as shown 
in Figure A. This requires some estimating of which important parameters belong in 
what module. 


3. List all program modules by name on a form as shown in Table A (address, size, and 
other details will be added later). 


4. Generate a flow chart for each module such as shown in Figures B and C. Identify 
all flags used and define the sense 1 or 0 as to meaning, e.g., ERROR = 1. Add the 
flag information to Table A. 


As the modules are developed, be sure every flag is set to 0 and 1 and tested. A 
common error is to forget to re-initialize the flag after it is used (see the ACK 
module ACK flag set). 


Make a list of module entry and exit names and add to Table A. 


5. Begin writing the module programs by writing only the function NAME on the 
program sheets, beginning each module at step 10. When learning to program, the 
writer usually omits some necessary startup step that can be later added as step 9, 
8, 7, etc. Leave room at the start. 
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Each module should be written on a separate program sheet. Do not be concerned 
about the DATA. Only write the function numbers for the functions that are 
related to other steps or functions, e.g., Preset. 


Be sure to use arrows and names for all jump destinations. Circle 
the address for all points at which other program operations will 
enter each module. An example is step 2E in Appendix 
A: “MSG”. 


Transfer the number of steps to the Table A form and add them to determine 
whether a 128- or 256-step cell is required. The total number of steps should leave 
at least 20% margin for the cell size selected for the first pass. | 


List all of the DTM set-up criteria. Now review the original sequence of operation 
and compare it to all the exit and entry points of the modules. | 


This is the first time the program is to be written as a consecutive listing. 
a. Always start with a NO-OP for the first step of any program. 


b. Select the module(s) requiring operator editing near the front of the program, 
e.g., terminal address entry. 


C. On the first writing, leave several spare steps between each program module. 
d. First fill in all program steps only with the functional description. 

e. Next fill in all entry and exit (JUMP) destinations with the names given. 

f. Next connect all the Jumps together by VAME. 


g. Next add the address (HEX) starting location for all start locations or entry 
points to Table A. 


h. Enter the Hex jump address to all Function 40, 41 steps. Check for 
completeness, e.g., all Jumps go to the proper place, etc. 


I. | Add all other function numbers. 

j. Add all other non-character data. 

k. Add all other character data (observing parity if required). 

Display the program on the INTERVIEW as own in Figure D. 

Operate the program. 

Debug of the program is assisted by observing the INTERVIEW and using the 


REVERSE image at various program locations to show the progress. HALT and 
beeps can be also used quite effectively to status the progress of the program. 
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2.0 RECEIVE SORT 


A generally accepted good practice is to use a common receive program to “‘sort’’ each receive 
transmission to classify it for action by DTM. The REC, ACK, S&S, AID modules show in detail an example of 
this capability. See Figures A and B-1. 


3.0 TRANSMIT 


Since all synchronous transmissions require several SYNC characters plus dynamic operation of the 
control leads, these repeated operations can be made into a subroutine common to all transmit sequences. Refer 
to the START TX subroutine Figure C-1 and Paragraph 11, Section II! and Figure F. 


4.0 EDIT 


An effective technique to make it easy for the operator to find the step to be edited is to precede the 
step with a NO-OP. The operator can then scroll search to the NO-OP, then step one more to the step to be 
edited. Refer to Section |, Paragraph 5 and Table 5-1. 


5.0 ALTERNATE BCC ERRORS 


Forcing the BCC error is an important test of the error recovery routine of the device being tested. A 
flag can be used as a one-bit counter to divide by 2. This permits alternating between a Good and Bad BCC by 
testing the flag. The MSG module Figure C-3 depicts this technique. Two flags will divide by 4, etc. 


6.0 MESSAGE GENERATION 


Functions 60 through 67 permit 8 messages to be canned in the DTM firmware. There are certain 
characteristics of special messages that should be considered: 


e There are two classes of messages: those that must be the first part of the transmit 
text, and those that can be used anywhere in the text. : 


e No message should include STX or SOH. This will permit generation of BCC by the 
DTM. 


e No message should include ETX. This will permit another message to be added onto 
the end to make a longer message. 


e When two or more messages are to be used as a sequence, one always follows the 
other. VO multiple character control function, such as (set buffer address) should 
bridge across from one message into the next. All control sequences must complete 
within a message. This allows intermixing of messages. 


e Messages should contain as many exercises of the terminal attributes as possible. 
The displayed format should be symmetrical and readable (in clear sentence 
structure if possible). 


e All messages should include both upper and lower case in a prominent way to 
ascertain the features of the terminal/device under test. 
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7.0 TRANSMIT TIMING 


The DTM permits precise determination of transmit timing. The time relationship between the last 
transmit character and turning off RTS may be critical to some systems. This delay can be accurately defined in 
1 ms increments or in terms of Bits (which of course remains constant as the bit rate changes). Paragraph 5.7 of 
section | describes the transmit timing criteria used here. 


8.0 SAVINGS PROGRAM STEPS 


As with any programmable test system, conservation of program memory permits more 
comprehensive programs to be used for a given program memory cell size. Economy can be achieved by using 
these techniques: 


e Use of Subroutines 


e Commonality of program modules to share common program steps. Refer to 
Figures B-3, C-2 and C-3. 


9.0 CLEAR RESULTS MEMORY 


Whenever the results memory is used to record in a test, it is good practice to clear it at the start of 
each program execution. A three-step sequence performs this in about 9 ms. This sequence is contained in Steps 
06, 07 and 08 of the program. Basically, Function 07 writes 00 into the RM and then the RM is tested to jump, 
when RM is NOT full, back to write 00 again. This process repeats until the RM is full and the program does not 
jump but falls through to the next program step. 


10.0 PROGRAM PATCH 


Usually every program at some time or other is used in a special case! Some change is usually required 
in the middle of a program module. 


A patch is obtained by placing in the step after the last valid instruction a JUMP to a vacant area of 
the program memory. The added program is written here and JUMPS back to the next valid instruction in the 
original program. This process ‘‘costs’’ two extra program steps (for the JUMPS) over the “perfect program”. 


11.0 SUBROUTINES 


| A subroutine is a short program module that is reused several times in a program. Instead of writing 
the same sequence of steps over again several times, it is only written once. | 


Since three steps are required to use a subroutine, the subroutine is only of value for more than three 
steps. However, a subroutine may also be used to permit the operator to enter a value or delay only once instead 


of several times in the program. 


Each using program module uses a conventional JUMP (Function 40) to get to the subroutine. 
Therefore, any program module can get to the subroutine. 


To return from the subroutine requires a conditional jump as the last step of the subroutine. The 
program should jump from the last step of the subroutine back into the program sequence from which it started. 


DTM conditional jumps go to the address previously PRESET (Function 41). The Format for 
subroutines is as follows: 
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a. Step N contains the JUMP (Function 40) to the subroutine address. 


b. Step N-1 contains the PRESET to the address which the subroutine will jump to 
when complete. Function 41 usually addresses step N+1. In many cases the 
subroutine can be directed to return anywhere in the program thus saving 
instructions. 


on The last step of the subroutine contains a known conditional JUMP. For example, 
START sets all flags to 0, so JUMP FLAG 0=0 will always jump to the most 
recent preset Function 41. 


d. Using this technique, a PRESET (Function 41) may NOT be used within the 
subroutine itself. 


NOTE 
DTM Serial number Series “F’’ and higher contain dedicated 
additional subroutine functions. This permits jumps in the 
subroutine — or nesting (e.g., one subroutine calling another 


subroutine). 


Function 27 Preset return address 
Function 28 Return 


Figure F shows graphically the use of a subroutine in a program. 
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Figure F. Subroutine. 
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